传递地址代币过滤器

传递地址代币过滤器用于对交易中涉及的传递账号（Accounts）所持有的代币资产进行风控判断，以防止代币通过交易间接流出。

---

一、过滤器定位

该过滤器是资产过滤体系中用于控制交易中传递账号的代币资产的安全机制。
它可以限制交易过程中，非钱包直接持有账户的代币变动，防止通过传递账号绕过钱包代币过滤器的风险。

• 解决的问题：交易中间接账户可能带走代币资产
• 与钱包代币过滤器的区别：钱包代币过滤器只控制钱包直接持有的 Token，传递地址代币过滤器控制交易中间接账户的代币资产

---

二、作用对象

• 交易中涉及的传递账号列表（Accounts）
• 这些账号所持有的代币资产（Token Account）

注意：只关注代币资产，不涉及本币余额（本币由传递地址余额过滤器控制）。

---

三、参数说明

传递账号代币过滤器支持基于账户白名单或黑名单的风控匹配策略，用于决定交易中哪些传递账号的特定代币资产需要纳入后续风控计算。

• 过滤模式（in_or_not）

  • 白名单模式（InList）
    仅将列表中的传递账号的指定代币纳入后续风控计算
    不在列表中的账号代币将被排除在本过滤器对应的风控范围之外
  • 黑名单模式（NotInList）
    列表中的传递账号代币将被排除在后续风控计算之外
    不在列表中的账号代币将进入后续风控计算

• 传递账号列表（list）

  • 指定需要参与风控判断的传递账号公钥列表（Pubkey）

• 代币（token）

  • 指定针对的代币 Mint 地址
  • 仅该代币资产会被纳入白名单/黑名单匹配

注意：该过滤器仅决定特定传递账号的代币是否纳入后续风控计算，不直接控制交易成功与否。

---

四、经典使用场景

• 防止交易中间接账户携带大量代币进行操作，从而绕过钱包代币过滤器的风控规则
• 限制特定传递账号的代币参与风控，防止误判或资产异常流出
• 与传递地址余额过滤器配合使用，确保交易中本币和代币资产都被有效控制